home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Prog / N-P / one liners < prev    next >
Encoding:
Text File  |  1990-10-03  |  8.2 KB  |  155 lines  |  [TEXT/McSk]
  1. Article 2581 (16 more) in comp.sys.mac.programmer:
  2. From: pepke@gw.scri.fsu.edu (Eric Pepke)
  3. Subject: Programmers' One-Liners
  4. Message-ID: <626@sun13.scri.fsu.edu>
  5. Date: 6 Sep 90 15:27:02 GMT
  6. Sender: news@sun13.scri.fsu.edu
  7. Organization: Florida State University, but I don't speak for them
  8. Lines: 145
  9.  
  10. It's been a while since I sent out a copy of these, so here goes.
  11.  
  12. Here is the latest version of the Macintosh Programmers' One-Liners.  It's now 
  13. two pages long.
  14.  
  15. The Macintosh One-Liners are intended to condense onto a couple of sheets of 
  16. paper information about some of the most common Macintosh problems and 
  17. programming pitfalls.  Each one-liner is a single line of text, shorter than 80 
  18. characters, which informs about one aspect of Macintosh use or programming.  
  19.  
  20. The one-liners are brief and do not give complete information about their 
  21. topics.  This is intentional.  Detailed documentation exists elsewhere, mostly
  22. in Inside Macintosh and in the Technical Notes.  If you need more information
  23. than is provided in a one-liner, you should be able to determine it by a little
  24. experimentation or by looking it up using the words in the one-liner as hints.
  25.  
  26. One-liners give either facts or advice.  The facts may be obvious to some 
  27. people and obscure to others but are important for all.  The advice is 
  28. intended to help keep people from running into the most common nontrivial 
  29. problems.  Like proverbs, the advice may not be absolute and may sometimes be 
  30. more conservative than is strictly neccessary.  However, I have found that a 
  31. little constructive paranoia can go a long way toward avoiding problems, and
  32. more than once I have taken a precaution which seemed extreme at the time but
  33. which saved my skin later on.
  34.  
  35. The one-liners started as a list I made for myself of things to remember
  36. while writing programs.  I have augmented them with my condensed records of
  37. several years of Info-Mac, Usenet, and Delphi digests and one year of Usenet 
  38. reading.  People who have contributed to the list since its first release are 
  39. mentioned at the end.  The result is very much a gestalt of the Macintosh lore 
  40. I have seen and depends on the wisdom and efforts of many people.  If I have
  41. forgotten to include your name, I apologize.
  42.  
  43. Send suggestions for additional one-liners to pepke@gw.scri.fsu.edu on the
  44. Internet or PEPKE@FSU on BITNET.  Have fun.
  45.  
  46. The Main Loop and Events
  47. Call MaxApplZone and MoreMasters when the application starts up.
  48. If you call SetApplLimit, do it before calling MaxApplZone.
  49. Use HT in MacsBug while running to estimate how many times to call MoreMasters.
  50. Don't use SetEventMask to disable mouseUp events.  Better not to use it at all.
  51. SetPort to a known good grafPort once every time through the event loop.
  52. Calling WaitNextEvent with more than 50 ticks will fail on some systems.
  53. Set the cursor on suspend and resume events.
  54. Call GetDblTime to get the maximum time for a double click.
  55. Measure double click time from mouse up to mouse down.
  56. Call either WaitNextEvent or both GetNextEvent and SystemTask.
  57. Call IsDialogEvents and DialogSelect even if GetNextEvent returns false.
  58.  
  59. Menus
  60. Use SetItem to include meta characters literally in menus.
  61. Never make MENU resources purgeable.
  62.  
  63. Resources
  64. GetResource never produces resNotFound.  Check for a NIL handle instead.
  65. To create a resource file, call Create, then CreateResFile.
  66. To open a resource file read-only for shared access, use OpenRFPerm.
  67. Don't leave ResLoad set to false.
  68. GetResource on a dctb may return a non-resource copy of the dctb.
  69.  
  70. Windows, Alerts, and Dialogs
  71. Move and size windows to the bounding box of GetGrayRgn.
  72. Hide scroll bars when deactivating a window.
  73. Call DrawGrowIcon when activating or deactivating a window with a grow region.
  74. DrawGrowIcon does not check to see if the window has a grow region.
  75. Call PenNormal before calling DrawGrowIcon.
  76. itemHit will not be set when a dialog filter is called.
  77. Use a disabled UserItem to draw the roundrect outline around the OK button.
  78. ModalDialog assumes the dialog is already visible and in the front.
  79. Use screenBits . bounds to center dialogs, alerts, etc. below the menu bar.
  80. If you save window locations in files, they may not be valid for all monitors.
  81. DragWindow expects startPt in boundsRect; if not it may not call SelectWindow.
  82. SelectWindow does not automatically call SetPort.  You must do that yourself.
  83. DialogSelect responds to activate events but ignores suspend/resume events.
  84. Call PenNormal before calling DrawControls.
  85. If you use SetOrigin, call SetOrigin(0, 0) before calling DrawControls.
  86. To find the position of a window, use LocalToGlobal on the origin.
  87. The Window Manager erases windows to the WMgr port's bkPat, not the window's.
  88.  
  89. Drawing
  90. Always set the VisRgn and ClipRgn of offscreen ports.
  91. Set the ClipRgn first when making a picture.
  92. Don't make rowBytes in bitMaps greater than 8191.
  93. To dim text, draw a rectangle with penPat=gray and penMode=patBic over it.
  94. To draw rotated text, draw to an offscreen bitmap, rotate it, and CopyBits it.
  95. Don't use picSize to determine the size of a picture.  Check the handle size.
  96. Never draw outside a window except in XOR mode for temporary effects like drag.
  97. To avoid animation flicker, synchronize drawing to the vertical retrace.
  98. Lock handles to pictures before calling DrawPicture.
  99. CopyBits on more than 3Kb data will work, but it might have to allocate memory.
  100. The small Mac screen is 512 pixels wide by 342 pixels high including menu bar.
  101.              
  102. Files
  103. Don't write in the application file.  This will fail with read-only devices.  
  104. Use PBGetVInfo to convert a VRefNum to a volume name. 
  105. Delete uses the Poor Man's Search Path, so don't delete blindly.
  106. File Manager routines with dirID=0 use the Poor Man's Search Path.
  107. Truncate and reallocate files before overwriting to reduce fragmentation.
  108. Check/change the creator and type of Save As... files before overwriting.
  109. If you rewrite files by deleting and creating, copy all Finder information.
  110. Directory ID's are longs, not shorts.  Shorts work ALMOST all the time.
  111. If a file version number appears in a file manager call, always set it to 0.
  112. To convert a pathRefNum to a name or file number, use PBGetFCBInfo.
  113. Prevent the creation of files with names that begin with a period.
  114. Write/update the Finder info before writing data or resource forks.
  115.  
  116. Interrupts and VBL Tasks
  117. Don't call any Memory Manager routines during an interrupt.
  118. Unlocked handles may not be valid during an interrupt.
  119. To synchronize to the vertical retrace on Macs with slots, use SlotVInstall.
  120.  
  121. Handles and Pointers
  122. Lock handles before passing their dereferenced pointers to any routine.
  123. Lock handles before setting referenced data to expressions containing functions
  124. Put an odd long at location zero on a 68000 to help find NIL handle references.
  125. Call MoveHHi before locking a handle to avoid memory fragmentation.
  126. Use HGetState/HLock/HSetState to lock a handle then put it back as it was.
  127.  
  128. General
  129. Always use unsigned characters within text and Pascal-format strings.
  130. Save application preferences in a folder named Preferences in the System Folder
  131. Use SysEnvirons to find the System (Blessed) Folder.
  132. Use GetAppParms to get the name of the application.
  133. The high bit of SysParam . volClik enables the alarm clock.
  134. Check the application name at $910 before exiting with ES within MacsBug.
  135. To exit to shell in the mini-debugger, enter SM 0 A9 F4 and then G 0.
  136. In Pascal, don't nest procedures to be passed by procedure pointer.
  137. In Pascal, "with theHandle^^" is unsafe if memory compaction can occur.
  138.  
  139. Controversy Corner (Don't shoot me; I'm just the messenger.)
  140. Avoid writing tail patches for traps.
  141. There is no official way to tell if MultiFinder is running or not.
  142.  
  143. Compiled by Eric Pepke
  144. Additional material by Steve Maker, Keith Rollin, Gregory Dudek, Brian Bechtel,
  145. Henry Minsky, Carl C. Hewitt, Jim Lyons, Alex Lau, Kent Borg, Peter W. Poorman,
  146. Ross Yahnke, Mark Fleming, Mark Anderson.
  147.              
  148. Eric Pepke                                    INTERNET: pepke@gw.scri.fsu.edu
  149. Supercomputer Computations Research Institute MFENET:   pepke@fsu
  150. Florida State University                      SPAN:     scri::pepke
  151. Tallahassee, FL 32306-4052                    BITNET:   pepke@fsu
  152.  
  153. Disclaimer: My employers seldom even LISTEN to my opinions.
  154. Meta-disclaimer: Any society that needs disclaimers has too many lawyers.
  155. End of article 2581 (of 2597)--what next? [npq]